home *** CD-ROM | disk | FTP | other *** search
/ HyperLib 1997 Winter - Disc 1 / HYPERLIB-1997-Winter-CD1.ISO.7z / HYPERLIB-1997-Winter-CD1.ISO / オンラインウェア / COM / BulkRate 2.5b2 Folder.sit / BulkRate 2.5b2 Folder / BulkRate 2.5b2 / BulkRate help < prev    next >
Text File  |  1996-03-01  |  68KB  |  884 lines

  1. BulkRate incoming mailbox
  2. *BulkRate Help         Introduction                                  About BulkRate
  3.  
  4.  1624 
  5. INTRODUCTION
  6.  
  7. BulkRate is an offline reader for FirstClass BBSs.  Using BulkRate, you can quickly capture all new mail and messages, then read and reply to them while "offline," or no longer connected to the BBS.  This minimizes the amount of time you spend online, which has two benefits: one, if the BBS you call is a toll call for you, you save money.  Two, if the BBS is a busy one, the line is freed up for another's use more quickly.
  8.  
  9. BulkRate works only with FirstClass BBSs. You must have an active account on a FirstClass BBS before using BulkRate with that BBS. 
  10.  
  11. BulkRate connects to the FirstClass BBS via FirstClass's CLUI (Command Line User Interface).  Not all FirstClass BBSs support this, though most do.  If yours doesn't, you cannot use BulkRate with it.
  12.  
  13. Unlike some offline readers for use with other BBS systems, BulkRate does not compress messages and mail or employ error checking, so it is subject to line noise and random errors.  If, however, you have a relatively clean phone line and/or a modem that supports data compression and error correction, this should not present much of a problem.
  14.  
  15. BulkRate is ゥ1991-1995 by Greg Neagle.  Versions prior to 2.0 were free (I asked users to send me a postcard).  They still are, but I have discontinued all support for versions prior to 2.0.  Versions 2.0-2.1 and any subsequent versions of BulkRate are SHAREWARE.  I ask $25 US. 
  16.  
  17. BulkRate 2.1 was created using Zedcor's FutureBasic and Staz Software's PG:PRO.  FutureBasic is a BASIC compiler for the Macintosh, and PG:PRO is a interface designer/application framework/function library rolled into one.
  18.  
  19. *BulkRate Help         Introduction                                 Getting started
  20.  
  21.  4371 
  22. GETTING STARTED
  23.  
  24. If you are a current user of BulkRate 1.x, you can skip to step 2 below.
  25.  
  26. 1) Log on to your FirstClass BBS using FirstClass Client.  When the Desktop window opens, choose "New folder" from the Conference menu. A new folder should appear on your (FirstClass) Desktop.  Select the folder and choose "Get Info..." from the File menu.  In the Get Info dialog, change the folder's name to "BulkRateToRead" -- make sure there are NO spaces in this name.  If you want to use a different name, make sure it has no spaces in it, and be sure to enter this name under "Exchange settings" in BulkRate.
  27. Now, go find the conferences you are interested in having BulkRate read for you.  Select them, then choose "Make alias" from the Conference menu. (These FirstClass aliases have nothing to do with System 7 file aliases.) This will create aliases of the selected conferences on the FirstClass Desktop. (You cannot and need not alias your Mailbox.) Once you have aliased all the desired conferences (make sure you get any wanted sub-conferences that reside inside other conferences), return to the FirstClass Desktop.
  28. To finish, drag all the aliased conferences into your new BulkRateToRead folder.  Make sure to scroll around the FirstClass Desktop to be sure you have moved all the aliases.  You can then log off the BBS.
  29.  
  30. 2) Launch BulkRate by double-clicking on its icon.  After the splash screen goes away, you'll see a standard files dialog.  If you have used an older version of BulkRate, select a BulkRate 1.x settings file (now called a "Service file") via this dialog.  Otherwise, you may select a FirstClass settings file.
  31. BulkRate will convert the settings files to its own format.  You'll see a window that shows the name of the BBS, your UserID, your password (in bullets), and the phone number or numbers of the BBS.
  32. When BulkRate converts a FirstClass settings file, it converts only UserID, Password, and the phone number.  It does not convert any modem information for two reasons: one, all the information is not stored in the settings file; and two, correct modem settings for FirstClass Client are not necessarily the correct modem settings for BulkRate.
  33.  
  34. 3) Choose "Service setup..." from the Service menu.  A large dialog will open.  To start, you can probably leave everything in this dialog as is.  The "Services" section contains details on customizing these settings.
  35.  
  36. 4) Click the "Modem settings..." icon.  You'll see a dialog that allows you to set up BulkRate to properly communicate with your modem.  Choose the port to which your modem is connected, dial type, and speed.  
  37.  
  38. "Hayes-compatible modem" should almost always be checked; in fact, the only modem I am aware of that it needs to be unchecked is the old Apple 1200 modem.  
  39.  
  40. "Hardware handshaking" must be checked if you are planning on using speeds above 9600; however, in order to use hardware handshaking, your modem must support it and you must have the proper cable.  Most modems sold for use with a Macintosh that work at 14400 bps or above come with the correct cable. 
  41.  
  42. Check "Modem speaker on" if you wish to hear the modem speaker while it dials and negotiates a connection.  
  43.  
  44. "Adjust BPS after connect" is a bit more complicated.  If your computer-to-modem speed can be set to a different speed than the modem-to-modem speed (generally true for 9600 bps and faster modems), you want to uncheck this option. Also, if you are using hardware handshaking, you probably want this option off.  For most 1200 and 2400 bps modems, you will want to check this option. See the "Modems" section for more detail.
  45.  
  46. The last option in the Modem settings dialog is a field for a "Modem initialization string."  This string is generally not the same as the setup or initialization string for FirstClass Client. In most cases, the "default" or "recommended" Macintosh string (see your modem manual) is the appropriate string.  See the "Modems" section for more detail.
  47.  
  48. 5) Click "OK" in the Modem settings dialog.
  49.  
  50. 6) Choose "Save service as..." from the Service menu and give the file a name; perhaps the same as the BBS.
  51.  
  52. 7) Click the "Exchange mail now" icon.  BulkRate will log onto the BBS and retreive all flagged messages from the conferences on the Desktop and in your BulkRateToRead folder.
  53.  
  54. 8) Click the "Incoming mail" icon to see a list of the mail BulkRate captured.
  55.  
  56.  
  57. *BulkRate Help         Introduction                                 Reading your mail
  58.  
  59.  801 
  60. READING YOUR MAIL
  61.  
  62. Reading your mail is simple.  Click the "Incoming mail" icon in the Service window or choose "Incoming mail" from the View menu.  A window will open, listing all the messages in that mailbox.  Unread messages are flagged, just like in FirstClass Client.  You may sort this list using the View menu.  Double-click on a message to open it for reading.
  63. Once you've read a message, you have several options.  You may close it and choose another from the list.  You may choose "Next unread" or "Next in thread" from the Mail menu.  You may click any of several buttons on the Palette. (See the section on the Palette for a complete description of your options here.) Finally, you can simply advance to the next message by hitting the return key, the enter key, or the right arrow key.  
  64.  
  65.  
  66. *BulkRate Help         Introduction                                 Replying mail
  67.  
  68.  640 
  69. REPLYING TO MAIL
  70.  
  71. If you'd like to reply to a message you're reading, choose "Reply" from the Mail menu, or click the "REPLY" button on the Palette.  A new outgoing message will be created, and the appropriate information will be entered for you.  If you select some text in the incoming message before replying, the selected text will be copied to the outgoing message and formatted as a quote, depending on the options you've set in Quoting Preferences.  (See the Preferences section for details.)
  72. You may also choose to reply to all addressees, just the sender, or just the conference by using the Reply special item under the Mail menu.
  73.  
  74. *BulkRate Help         Introduction                                 Forwarding mail
  75.  
  76.  277 
  77. FORWARDING MAIL
  78.  
  79. You may forward an incoming message to someone else by choosing "Forward" from the Mail menu or clicking the "FWD" button on the Palette.  The entire text of the message will be copied to a new outgoing message, ready for you to add new addressing information.
  80.  
  81. *BulkRate Help         Introduction                                 Creating new mail
  82.  
  83.  167 
  84. CREATING A NEW OUTGOING MESSAGE
  85.  
  86. You may create a new, blank outgoing message by choosing "Compose new" from the Mail menu or clicking the "NEW" button on the Palette.
  87.  
  88. *BulkRate Help         Service files                                Service window
  89.  
  90.  1124 
  91. SERVICES
  92.  
  93. A service file stores important information for each "service" or BBS. This information is divided over five windows:
  94.  
  95. Service window:
  96.  
  97. Host name: 
  98.      The name of the service or BBS.  For the Address Book to work correctly, it's important that this name match the Service name in any Address Book entries for that service.  (If the BBS is gatewayed to other BBSs, use the name that appears after the comma on gated messages.)
  99.  
  100. UserID: 
  101.      This is your unique account name on that BBS; it may be the same as your screen name, it may not.  If you convert an existing FirstClass settings file, the UserID is automatically imported for you.
  102.  
  103. Password: 
  104.      Your password on the FirstClass BBS.  Again, this can be automatically imported from a FirstClass settings file.  Note that passwords and UserIDs that use extended characters (characters generated by holding down the option key, or with ASCII values higher than 127) cause problems with the CLUI, and thus with BulkRate.
  105.  
  106. Phone number(s): 
  107.      You can enter multiple phone numbers for a BBS; if one is busy, BulkRate will dial the next number in the list.
  108.  
  109. *BulkRate Help         Service files                                Mailbox settings
  110.  
  111.  1057 
  112. MAILBOX SETTINGS
  113.  
  114. Incoming mail filename and Outgoing mail filename.
  115.      These two entries are very important.  They determine which files BulkRate will use for incoming and outgoing mail for that BBS.  Although you can type into the appropriate fields, I recommend that you use the "Create" buttons to create new files, this way you can choose the location of these files as well.  (The location must be on a mounted volume; BulkRate will not mount network volumes for you.)
  116.  
  117. Auto-delete... mail on close
  118.      If checked, these will casue mail that has been marked as read or sent mail (as appropriate) to be automatically deleted when you close a list window.
  119.  
  120. Auto-delete mail over... days old
  121.      If you check this and enter a number of days, amil older than the number of days you specify will be flagged for delete when you open the mailbox.  This will result in automatic deletion when you close the window unless you reset the flags manually.
  122.  
  123. Sort/Reverse sort
  124.      These options allow you to specify how you would like each mailbox to be sorted.
  125.  
  126. *BulkRate Help         Service files                                Exchange settings
  127.  
  128.  2957 
  129. EXCHANGE SETTINGS
  130.  
  131. "Look for conferences in:" (Conference path list)
  132.     The conference path list is simply a list of paths to conferences.  The default is:
  133.  
  134. Home
  135. Home:BulkRateToRead
  136.  
  137.      This default instructs BulkRate to read all flagged conferences on the Desktop (Home) and inside the "BulkRateToRead" folder, which can be found on the Desktop.  
  138.      Do not put the names of actual conferences here unless you wish BulkRate to look for flagged conferences INSIDE those conferences.  In other words, if there is a conference called "Member Forum" on the Desktop, "Home" is enough to get BulkRate to find it.  "Home:Member Forum" would fail.
  139.      Do not make the mistake of putting "Home:Mailbox" in this list.  This would cause BulkRate to open your Mailbox and look for flagged conferences INSIDE your mailbox.  Instead, if you wish to have BulkRate read your Mailbox, the default entry of "Home" should do it for you, since your Mailbox is in the "Home" or Desktop level.
  140.      Note that due to a limitation of the FirstClass CLUI (Command Line User Interface), you cannot specify paths that include spaces.  That's why the default "BulkRateToRead" folder has no spaces in its name.
  141.      You can create additional folders on your desktop and have BulkRate read what's in them simply by adding more lines to the conference path list; for example:
  142.  
  143. Home
  144. Home:BulkRateToRead
  145. Home:OtherToRead
  146.  
  147. "DON'T read these conferences:" (Don't read list)
  148.      This list simply tells BulkRate which conference not to read; this is especially useful if there are conferences on the Desktop you do not want BulkRate to read.  (Otherwise, simply do not place their aliases in the BulkRateToRead folder.)  Put each conference name on a seperate line. Do not include path information.
  149.  
  150. "DON'T read messages from these people:" (Kill list)
  151.      Similar in concept to the above list; this list targets certain people whose messages you do not want BulkRate to read.  Besides putting annoying people in this list, you can also put yourself in this list to keep BulkRate from picking up mail you have just sent.  Put each nme on a seperate line.
  152.  
  153. Your screen name:
  154.      If you would like BulkRate to refrain from putting your name into the cc list when to reply to a message, put your name as it appears on the BBS in this field.  This may or may not be the same as your UserID.
  155.  
  156. Use threaded replies:
  157.      This checkbox controls whether or not Bulkrate records the information needed for threaded replies when you generate a reply.  See the section on threaded replies for more info.
  158.  
  159. Delete mail on server...:
  160.      Checking this option will cause BulkRate to delete messages in your FirstClass MailBox in excess of the number you specify.  Enter the maximum number of messages to keep in your FirstClass MailBox.  After sending your outgoing mail and processing file retreival requests, BulkRate will delete any messages in your FirstClass MailBox in excess of this number.
  161.  
  162.  
  163. *BulkRate Help         Service files                                File transfer settings
  164.  
  165.  317 
  166. FILE TRANSFER SETTINGS
  167.  
  168. This dialog allows you to tell BulkRate from which conferences you would like BulkRate to automatically download files, and how large you will allow an automatically downloaded file to be.  Remember that you can always issue a file retreival request to have BulkRate retreive an attached file.
  169.  
  170. *BulkRate Help         Mailbox files                                Mailboxes and archives
  171.  
  172.  2354 
  173. MAIL BOXES AND ARCHIVES
  174.  
  175. BulkRate stores all mail in specially formatted text files which are called mailboxes.  There are two formats, one for incoming mail and another for outgoing mail.  Each service has an incoming mailbox and an outgoing mailbox associated with it.  You can set up or change this relationship by choosing "Mail settings..." under the Service menu.
  176.  
  177. On the right side of the Mail settings dialog are some fields and buttons that allow you to specify the name and location of the files you wish to use for Incoming and Outgoing mail.  There are basically two strategies you can use.  The first strategy is to use one incoming mail file and one outgoing mail file for all services.  The second strategy is to use separate files for each service.  For example, if you call LAMG BBS and DigitalPopcorn, you might have the following files:
  178.  
  179. LAMG BBS
  180.      Outgoing mail filename: LAMG Outgoing
  181.      Incoming mail filename: LAMG Incoming
  182.  
  183. DigitalPopcorn
  184.      Outgoing mail filename: DP Outgoing
  185.      Incoming mail filename: DP Incoming
  186.  
  187.  
  188. There are two advantages to using separate files: one, better organization, since messages from multiple BBSs don't end up in the same list, and two; it's easier to use BulkRate to read and write messages for one BBS while BulkRate is exchanging mail with another BBS.  The main disadvantages are that there are more files to keep track of, and it becomes easier to accidentally store replies or other outgoing mail in the wrong mailbox.
  189. (A third strategy that would eliminate that last disadvantage would be to use separate Incoming mail files for each service, but a single Outgoing mail file for all services.)
  190.  
  191. Archives are identical in format to mailboxes.  Archives can simply be thought of as inactive mailboxes.  If you choose "Save a copy as..." or "Archive selection..." under the File menu, you can create archives to store mail for later reading or printing.  "Save a copy as..." copies the entire mailbox to a new archive, "Archive selection..." copies the selected items to a new archive, and "Append to archive..." copies the selected items to the end of an existing archive.  (Note that since archives and mailboxes are really the same thing, you can append items to an "active" mailbox if you wish.  This might be useful for copying outgoing mail to be sent to several different BBSs.)
  192.  
  193. *BulkRate Help         Mailbox files                                Services and Mailboxes
  194.  
  195.  1211 
  196. THE POTENTIALLY CONFUSING BUT VITALLY IMPORTANT RELATIONSHIP BETWEEN SERVICES AND MAILBOXES
  197.  
  198. It is very important to understand the relationship between Service files and Mailboxes.  This relationship is defined under Mail settings... under the Services menu.
  199.  
  200. Each Service can be thought of as "owning" two files or mailboxes: an outgoing mailbox and incoming mailbox.  When you click on the "Incoming mail" or "Outgoing mail" icons in the Service window, BulkRate opens the file that is listed in the "Mail settings" dialog.  If you are reading incoming mail and decide to make a reply, the reply is created in the Outgoing mailbox that belongs to the currently open Service file.  This is a very important concept to understand: if you happen to be reading mail in an incoming mailbox that belongs to LAMG BBS, but you have the DigitalPopcorn service file open, the reply will be created in the DigitalPopcorn outgoing mailbox, which is probably not what you want.  The moral is that you should insure that the matching Service file is open when you are reading mail from a BBS.  (Again, it might be possible to minimize this problem by using the third mailbox strategy outlined in "Mailboxes and archives".)
  201.  
  202. *BulkRate Help         Windows                                      Service window
  203.  
  204.  1313 
  205. SERVICE WINDOW
  206.  
  207. This window contains information for the currently active Service, as well as clickable icons that act as shortcuts for exchanging mail and opening incoming or outgoing mail.
  208.  
  209. The host name is the name you wish to use to identify the BBS.  If you call multiple BBSs, make sure each has a unique name.  If you have multiple Service files for a single BBS, all files should have the same host name entered here.
  210.  
  211. The UserID and Password must be identical to those used in FirstClass Client.  An easy way to insure this is to have BulkRate pull the UserID and Password from a FirstClass Settings file.  Simply choose "Open service..." from the Service menu and choose a FirstClass settings file.  BulkRate will create a new Service file and enter host name, UserID, password, and a phone number for you.  You must still adjust your Mail settings and Modem settings.
  212.  
  213. When you type in a password, it will appear in readable text.  Hit the tab key to convert it to "bullets" for security.  Clicking back into the Password field will make the password readable again.
  214.  
  215. You may enter multiple phone numbers; BulkRate will dial each one in turn if it encounters a busy signal.
  216.  
  217. Click "Exchange mail now" to start a mail exchange.  Click "Incoming mail" or "Outgoing mail" to view the respective mailboxes.
  218.  
  219. *BulkRate Help         Windows                                      Incoming message list
  220.  
  221.  1166 
  222. INCOMING MESSAGE LIST WINDOW
  223.  
  224. This window shows you a list of all messages in a incoming mailbox.  You may read any item in the list by double-clicking on it.  Option-clicking an item toggles the flag which indicates that a message has been read.  You may also mark an item as read by choosing "Mark as unread" from the Mail menu.
  225.  
  226. You can sort the list by Conference, Name, Subject, Date or read/unread Status using the View menu.  The "by Default" sort type simply shows you the items in the order they are stored in the file.
  227.  
  228. You may delete items by selecting them and choosing "Mark for delete" from the Mail menu, or clicking the Delete button on the Palette.  This marks the items with a trashcan icon.  When you close the list window, these items will be removed from the mailbox file.
  229.  
  230. Choosing Forward from the Mail menu, or clicking the Palette FWD button will allow you to forward a selected message to another recipient.
  231.  
  232. Choosing Reply from the Mail menu or clicking the Palette REPLY button will create a reply to a selected message.  It's better to reply to a message that is open, however, as this allows you to quote text from the original message.
  233.  
  234. *BulkRate Help         Windows                                      Incoming mail
  235.  
  236.  1573 
  237. INCOMING MESSAGE WINDOW
  238.  
  239. You may read an incoming mail item using this window.  You may copy and edit text and change the font and size of selected text, but no changes are saved when you close the window or advance to another message.  You may quickly advance to the next message by pressing the return, enter or right arrow keys.  You can return to the previous message by pressing the left arrow key.  You may also use the Mail menu or Palette for more navigation options.
  240.  
  241. The space  bar can be used to somewhat intelligently step through messages: the current thread will be followed until there are no messages left in the thread, then it will read the first unread message in the list; follow its thread, if any, and so on until all unread messages are read.
  242.  
  243. Choosing Forward from the Mail menu, or clicking the Palette FWD button will allow you to forward this message to another recipient.
  244.  
  245. Choosing Reply from the Mail menu or clicking the Palette REPLY button will create a reply to this message.  If you wish to quote part of the message text in the reply, select the text before choosing or clicking "Reply."
  246.  
  247. If the message has files attached to it and you haven't configured BulkRate to automatically download file attachements, you may request that Bulkrate retreive any attached files on the next mail exchange by choosing "Request file" from the Mail menu, or by clicking the RQST button on the Palette.
  248.  
  249. Clicking the Palette DEL button or choosing "Mark for delete" from the Mail menu will mark this message for deletion and advance to the next message.
  250.  
  251. *BulkRate Help         Windows                                      Outgoing mail list
  252.  
  253.  1236 
  254. OUTGOING MAIL LIST WINDOW
  255.  
  256. This window is similar to the Incoming mail list window. It displays a list of all messages in an outgoing mailbox.  Option-clicking an item toggles the sent flag, which looks like a postmark.  This flag indicates that a message has been sent; unsent items will have no icon.  Items that were attempted to be sent, but failed, will be indicated with a circle-with-a-slash icon.  You can check the log for details as to why this message wasn't sent.  BulkRate will also send you a "non-delivery notification" which will appear in your incoming mailbox.  In most cases, the problem is an addressing problem.
  257.  
  258. You may sort the list by Host, Name, Subject, Date or sent/unsent Status by using the options available under the View menu.  Again, the "by Default" sort type simply displays the items in the order they exist within the mailbox file.
  259.  
  260. Double-click an item to open it for reading or editing.
  261.  
  262. You may delete items by selecting them (shift-click and command-click are supported) and choosing "Mark for delete" from the Mail menu, or clicking the Delete button on the Palette.  This marks the items with a trashcan icon.  When you close the list window, these items will be removed from the mailbox file.
  263.  
  264. *BulkRate Help         Windows                                      Outgoing mail
  265.  
  266.  1828 
  267. OUTGOING MAIL WINDOW
  268.  
  269. Use this window to edit outgoing mail.  Once you've created a new message, you can either Save it (under the File menu) or Queue to Send it (under the Mail menu).  Both actions are equivalent; Queue to Send (or the Palette "Post" button) takes the additional step of closing the window after saving the message in the outgoing mailbox.  Due to limitations of the FirstClass CLUI, outgoing messages over 5K in length will be automatically split into multiple parts when sent.  The FirstClass CLUI also does not recognize extended characters when composing mail.  Any extended characters you enter in the subject or body text of an outgoing message will be converted to regular ASCII text when the message is sent.  For example, "G殤ther" will be converted to "Guenther", and "BulkRateゥ" will be converted to "BulkRate(c)モ.
  270.  
  271. When editing an outgoing message, you can add addresses to the To or cc fields manually, or by using the Address Book.  
  272.  
  273. "Host:" contains the host name of the BBS this message is to be sent to; usually BulkRate fills this in for you.
  274.  
  275. The "Message sent" checkbox will be checked if you are viewing or editing a message that has already been sent to the Host BBS.  You can also manually toggle this to re-send the message .
  276. The "Hold message" checkbox can be checked to prevent BulkRate from sending a message.  You can then finish it at a later time and the uncheck this box.  This checkbox changes to "Delete message" if the message has been sent.
  277. The "Threaded reply" checkbox indicates whether or not a message is a threaded reply.  Uncheck this box to de-thread the reply.  Do not uncheck this box on a file retreival request, or the request will fail.
  278.  
  279. Clicking the Palette DEL button or choosing "Mark for delete" from the Mail menu will mark this message for later deletion. 
  280.  
  281. *BulkRate Help         Windows                                      Address book
  282.  
  283.  2047 
  284. ADDRESS BOOK WINDOW
  285.  
  286. This window simply contains a list of names, addresses, and services.  If an outgoing message is directly under the Address Book window, double-clicking on an entry (or selecting an entry and clicking the "Use" button) will add that address to the To field, unless the cursor was in the cc field, in which case the address will be added to the cc field.
  287. Another way to use the Address Book is to simply type the name into the To or CC fields of an outgoing message.  When you hit return, enter, or tab, the name will be replaced with the address you've entered (and a comma and the Host Service, if applicable).  For example, if you typed "Greg Neagle" and hit return, "Greg Neagle" would be replaced with "greg_neagle@pop.com,Internet".
  288. You may edit the items in the Address Book by clicking the Edit button, which expands the window to include the editor section.
  289. Add an address by typing it into the fields in the editor section and clicking "Add".
  290. You can add, delete, and replace Address Book items, open other address book files, or save the current Address Book as a new file.  Any Address Book file that is open when you quit BulkRate becomes the default Address Book and will be re-opened the next time you launch BulkRate.
  291.  
  292. Address Book edit fields:
  293.  
  294. Name: 
  295.      Stores the name of the addressee: you can put anything you want here, like "Dad", or "BulkRate tech support" - whatever name allows you to easily remember the entry.
  296.  
  297. Address: 
  298.      This is the actual FirstClass address or gatewayed address.
  299.  
  300. Host service: 
  301.      If the person is accessed through a gateway, this is the name of the gateway or FirstClass BBS accessed through a gateway.
  302.      For example: if you wanted to enter my address, and your FirstClass BBS has a gateway to Internet e-mail called "Internet", you could put "Greg Neagle" in the Name field, "greg_neagle@pop.com" in the Address field, and "Internet" in the Host service field.
  303. Otherwise, this name should EXACTLY match the Host name in the Service window, or you can leave it blank.
  304.  
  305. *BulkRate Help         Windows                                      Palette
  306.  
  307.  2095 
  308. PALETTE WINDOW
  309.  
  310. This windows serves much like FirstClass Client's palette window - it gives you easy one-click access to many message navigation and creation functions.  Normally the Palette opens in a vertical configuration, but if you hold down the option key while choosing "Palette" from the View menu, it will open in a horizontal configuration.  As long as the Palette is open while you quit BulkRate, it will re-open automatically in the same configuration when you re-launch BulkRate.
  311.  
  312. Palette buttons:
  313.  
  314. NEW: creates a new outgoing message in the outgoing mailbox for the currently open service.
  315.  
  316. POST: Queues an outgoing message to be sent. (The outgoing message is saved in the outgoing mailbox and the window is closed.)  Note that this mail is not actually sent until you choose "Exchange mail now" or otherwise initiate a mail exchange.
  317.  
  318. REPLY: Creates a reply to the current incoming message.  If you have selected text in the incoming message before clicking "REPLY," the text will be quoted in the outgoing message.
  319.  
  320. FWD: Creates a new outgoing message that forwards the text of the current incoming message to new recipient.
  321.  
  322. ATTCH: Attaches a file to an outgoing message.
  323.  
  324. RQST: Request that an attached file be retreived from the server on the next mail exchange.
  325.  
  326. FIND: Allows you to find text in a mailbox or the log.  Holding the option key down as you click this button is the same as choosing "Find text again" from the menu.
  327.  
  328. DEL: Marks to deletion the currently open message, or any selected messages in a list window.
  329.  
  330. PREV THRD: (Previous in Thread) Finds the first previous message with the same subject as the current message.  This is not "true" threading, but is the best possible approximation.
  331.  
  332. NEXT THRD: (Next in Thread) Finds the next message with the same subject as the current message.
  333.  
  334. FIRST UNRD: (First Unread) Finds the first unread message in the list.
  335.  
  336. NEXT UNRD: (Next Unread) Finds the next unread message after the current message.
  337.  
  338. PREV MSG: (Previous message) Displays the previous message.
  339.  
  340. NEXT MSG: (Next message): Displays the next message.
  341.  
  342. *BulkRate Help         Windows                                      Mail log
  343.  
  344.  295 
  345. MAIL LOG WINDOW
  346.  
  347.  
  348. This window displays the contents of the BulkRate log, which can be useful for troubleshooting, reviewing the actions a script accomplished, determining why certain messages were not sent, or determining logon and logoff times.  BulkRate saves only the last 30-32K of activity.
  349.  
  350. *BulkRate Help         Windows                                      Exchange status
  351.  
  352.  200 
  353. EXCHANGE STATUS WINDOW
  354.  
  355. This window is visible whenever a mail exchange is in progress.  It displays information about the current exchange.  Click the Cancel button to cancel an exchange in progress.
  356.  
  357. *BulkRate Help         Menus                                        File menu
  358.  
  359.  1446 
  360. FILE MENU
  361.  
  362.  New: 
  363.      Creates a new outgoing message in the Outgoing mailbox owned by the currently open Service.
  364.  
  365.  Open: 
  366.      Allows you to open any text file, which includes mailboxes, archives, the Address Book, the BulkRate log, and any other text file.  A text file that is not of one of the above types will be opened as the text of a new outgoing message.
  367.  
  368.  Close: 
  369.      Closes the topmost open window.  If you close a mailbox list window, all associated message windows will close as well.
  370.  
  371.  Save: 
  372.      This item is only active when there is a outgoing message in the top window.  Use it to save outgoing mail in the outgoing mailbox.
  373.  
  374.  Save a copy as.../Save as text...: 
  375.      This item changes depending on which window is topmost; you can create a copy of a mailbox and all messages within, or you may save any message as a text file (creator type is TeachText).
  376.  
  377.  Archive selection.../Archive message...: 
  378.      If you have messages selected in a mailbox list window, you can use this command to save them in a separate archive, or if the topmost window is a message window, you can save the current message as a new archive.
  379.  
  380.  Append to archive...: 
  381.      Use this command to append selected mailbox list items or the current message to an existing archive or mailbox.
  382.  
  383.  Page setup...: 
  384.      Brings up a standard Page Setup dialog.
  385.  
  386.  Print...: 
  387.      Allows you to print the text of a message or the log.
  388.  
  389.  Quit: 
  390.      Quit BulkRate.
  391.  
  392. *BulkRate Help         Menus                                        Edit menu
  393.  
  394.  1695 
  395. EDIT MENU
  396.  
  397.  Undo: 
  398.      Allows you to undo text changes.  You cannot, however, undo the saving or deleting of a message.
  399.  
  400.  Cut, Copy, Paste, Clear: 
  401.      Allow you to do the standard editing functions on text.
  402.  
  403.  Select all: 
  404.      Use to select all text, or all messages in a list.
  405.  
  406.  Font, Size: 
  407.      Use these menus to temporarily change the font and/or size in an incoming message; this might be useful to line up columns in a message originally composed in a monospaced font.  If you'd like to permanently change the default font and size of text in messages, use "Preferences..." under the Service menu.
  408.  
  409.  Find text, Find text again
  410. Use these to find text in a mailbox or the log.  BulkRate will search through all the messages in an open mailbox to find the requested text.
  411.  
  412.  Preferences...
  413.      Opens a dialog allowing you to specify how BulkRate behaves in various situations.  These are global settings and are not saved with each Service, but rather apply to every Service.  See the Preferences section for more details.
  414.  
  415.  Register...
  416.      Opens a dialog that allows you to register BulkRate.  Remember: BulkRate is now shareware.  I ask $25 US as a shareware payment. Once you enter the registration code, the "- sent by an evaluation copy of BulkRate (unregistered)" tagline will cease to be added to your outgoing messages.  File transfers are disabled in the evaluation version of BulkRate.  If you register BulkRate, file transfers will become available.
  417.  
  418. If you live outside of California, you may pay for BulkRate via MasterCard or Visa.  Your credit statement will show a charge from "DigitalPopcorn Online Services."  They are the authorized reseller of BulkRate registrations.
  419.  
  420. *BulkRate Help         Menus                                        Mail menu
  421.  
  422.  2463 
  423. MAIL MENU
  424.  
  425.  Compose new
  426.      Creates a new outgoing message in the outgoing mailbox "owned" by the currently open Service file.
  427.  
  428.  Queue to send
  429.      Saves an outgoing message in the outgoing mailbox, then closes the window.  This does not actually send the message to the host BBS.  You must initiate a mail exchange to actually send the message.  Due to limitations of the FirstClass CLUI, any message that is over 5K in length will be automatically split into multiple parts when sent.
  430.  
  431.  Reply
  432.      Creates a reply to an incoming message.  If text is selected in the incoming message, it will be automatically "quoted" to the new outgoing message.  You can customize how the text is quoted by selecting Preferences... under the Edit menu.
  433.  
  434. Reply special
  435.      Allows you to direct a reply to all addressees, the sender only, or the conference only, overriding the default reply behavior, which is to send to the conference only for conference replies, and to all for MailBox replies.
  436.  
  437.  Forward
  438.      Allows you to forward an incoming message.
  439.  
  440.  Next unread
  441.      Opens the next unread message in the list.
  442.  
  443.  Next thread
  444.      Finds and opens the next message in the list with the same subject (or variation thereof) as the current message.  This is not "true" threading, but is all that is possible with the CLUI interface.
  445.  
  446.  Mark for delete
  447.      Marks the current message (or currently selected messages in a list) for later deletion.  When the list window is closed, messages marked for deletion will be removed from the mailbox.  If you hold down the option key while selecting this, the name of the menu item changes to simply "Delete" and it immediately deletes the current message, or multiple messages if more than one is selected in a message list. 
  448.  
  449.  Mark as unread
  450.      Use this command to mark the currently selected messages in an incoming list as unread, or mark the current incoming message as unread.
  451.  
  452.  Attach file
  453.      Prompts for a file to attach to an outgoing message.
  454.  
  455.  Request file
  456.      Generates a file retreival request if the current incoming message has one or more attached files.
  457.  
  458.  Exchange mail now
  459.      Use this command to start a mail exchange with the currently open service.
  460.  
  461.  Exchange mail later...
  462.      This command allows you to specify a future time for a mail exchange to begin.
  463.  
  464.  Script...
  465.      Opens the script dialog, which allows you to create, edit, open, save, and run scripts.  See the Scripting section for more details.
  466.  
  467. *BulkRate Help         Menus                                        Service menu
  468.  
  469.  722 
  470. SERVICE MENU
  471.  
  472.  New service
  473.      Creates a new empty Service file.
  474.  
  475.  Open service...
  476.      Allows you to open a Service file, or convert an old BulkRate settings file, or a FirstClass settings file.  Note that if you are "converting" a FirstClass settings file that the only information converted is Host name, UserID, Password, and Phone number.  Modem settings and mail settings will have to be entered by you.
  477.  
  478.  Save service...
  479.      Allows you to save changes to a Service file.
  480.  
  481.  Save service as...
  482.      Allows you to save a Service file under a different name.
  483.  
  484.  Service setup...
  485.      Opens a dialog allowing you to set various options pertaining to the current service.  See the Service setup section for more details.
  486.  
  487. *BulkRate Help         Menus                                        View menu
  488.  
  489.  1403 
  490. VIEW MENU
  491.  
  492.  by Default  through  by Status:
  493.      This group of menu items allow you to sort a message list to your liking. "by Subject" does a pseudo-thread sort, grouping messages by Conference, Subject, and Date.  "by Status" groups read/unread items or sent/unsent/can't send items.  "by Default" simply displays the items in the order they exist with in the mailbox file, and is the fastest.
  494.  
  495.  Reverse sort
  496.      Reverses the direction of the selected sort.
  497.  
  498.  Address book
  499.      Opens the Address book.  See the BulkRate Windows:Address book section for more details.
  500.  
  501.  Palette
  502.      Opens the Palette.  See the BulkRate Windows:Palette section for more details.  If you hold the option key down while opening the Palette, it will open in a horizontal configuration.
  503.  
  504.  Log
  505.      Opens the log.  The log is simply a text file detailing BulkRate's past actions.  If it grows to over 32K in size, BulkRate deletes old material to bring it under 32K.  You can cause BulkRate to write more detailed information to the log by checking "Include debugging info in log" under Preferences.
  506.  
  507.  Incoming mail
  508.      Opens the incoming mailbox "owned" by the currently open Service file.
  509.  
  510.  Outgoing mail
  511.      Opens the outgoing mailbox "owned" by the currently open Service file.
  512.  
  513. All other menu items in this menu are the names of currently open windows.  You can quickly switch to another open window via these items.
  514.  
  515. *BulkRate Help         Preferences                                  General preferences
  516.  
  517.  1137 
  518. GENERAL PREFERENCES
  519.  
  520. Include debugging info in log:
  521.      When this option is chosen, virtually everything that comes over the modem port is written to the log file.  This can be useful for determining why BulkRate isn't working as one would expect, since it allows you to see exactly what is being sent by the FirstClass CLUI.
  522.  
  523. Palette button sounds: 
  524.      Turns on or off the sounds made when clicking a palette button.
  525.  
  526. Use a message tag line:
  527.  This allows you to add random one-line "tags" to the end of your messages.  BulkRate will pick a single line at random from this list and add it to end of your outgoing messages.  Note that this is a tagline, not a signature file.  For information on creating and using signature files, see Adding a ヤsignatureユ to your messages in the Hints and Tips chapter of this document.
  528.  
  529. Max redials/Redial delay
  530.      Use these to tell BulkRate how many times to try dialing a BBS  before giving up, and the time in seconds to wait between attempts.
  531.  
  532. Default font/Size
  533.      Use these pop-up menus to choose the default font and size in which you would like incoming and outgoing mail to be displayed.
  534.  
  535. *BulkRate Help         Preferences                                  FirstClass preferences
  536.  
  537.  1145 
  538. FIRSTCLASS PREFERENCES
  539.  
  540. These are related to the Preferences you can set in FirstClass Client.  It's important to set these to the way you'd like them set when using FirstClass Client, as BulkRate changes the preferences to what it requires during a mail exchange.  It uses the settings in this window to reset the FirstClass Preferences. 
  541.  
  542. Show items in conferences in reverse order
  543.      This causes FirstClass to show list items with the newest items first.  Set this to however you'd like it to be when using FirstClass Client.
  544.  
  545. Show only unread items in conference
  546.      This causes FirstClass to hide items you've already read.  BulkRate automatically turns this setting on when it does a mail exchange; if you uncheck this, BulkRate will turn it back off as it logs off.
  547.  
  548. Don't accept invitations
  549.      This keeps chat requests from coming to you; BulkRate automatically turns this setting on when it does a mail exchange; if you uncheck this, BulkRate will turn it back off as it logs off.
  550.  
  551. Sounds during chat and invite
  552.      This controls sounds during a chat session.  Set this to however you'd like it to be when using FirstClass Client.
  553.  
  554. *BulkRate Help         Preferences                                  Quoting preferences
  555.  
  556.  555 
  557. QUOTING PREFERENCES
  558.  
  559. Wrap text at ___ characters
  560.      Controls the width of quoted text.  Set this to 0 if you don't want BulkRate to wrap quoted text at all.  70 works well because it allows quoted text to be requoted without going over 80 characters.
  561.  
  562. Include attribution line
  563.      This controls whether or not BulkRate precedes quoted text with a line giving attribution to the originator.  It's good form to do so.
  564.  
  565. Quote characters
  566.      This group of controls allows you to customize what characters BulkRate uses to proceed each line of quoted text.
  567.  
  568. *BulkRate Help         File transfers                               Downloads
  569.  
  570.  2585 
  571. FILE TRANSFERS
  572.  
  573. BulkRate 2.1 now supports file transfers.
  574. File transfers are available only on registered copies of BulkRate.
  575.  
  576. Downloads
  577. There are two ways to have BulkRate download files that are attached to messages.  The first is to specify which from conferences you would like BulkRate to automatically download files under a certain size.  You can do this by choosing "Service setup..." under the Service menu, then clicking on the File Transfers icon.
  578.  
  579. In this dialog, you can enter the names of conferences in which BulkRate should automatically download file attachments, and the size limit on these automatic downloads.  The default setting is to automatically download any files under 100K attached to messages in your MailBox.  Any files downloaded will appear in a folder named "BulkRate downloads" in the same folder as the BulkRate application.
  580.  
  581. The second way to download files with BulkRate is a two-step process: step one is a normal mail exchange, in which BulkRate only retreives the text of messages and ignores file attachements.  If while reading through the incoming mail you notice a file you want, you can then Choose "Request file" under the Mail menu, or click the RQST button on the Palette.  This will cause BulkRate to create what looks like a threaded reply, but in actuality is a File Request - a command and the information needed to retreive the desired file or files during the next exchange.
  582. Note: there is nothing preventing you from editing a File Request message, but if you want the Request to actually work, do not edit it with the exception of removing a file or files from the list of those to retreive.  (This may happen if a given message has multiple files attached to it.)
  583. Click POST on the Palette or choose "Queue to send" from the Mail menu, and the request will be saved to your outgoing mailbox.
  584. During the next mail exchange, while sending mail, BulkRate will also retreive any files requested by you.  Note that the file retreival is not a seperate process, but rather is interleaved with the sending of mail.  You could easily have a new message, a file retreival request, another new message, another file request, and a reply to a message in that order in your outgoing mail.  BulkRate will process the items in your outgoing mail in the order they are saved to the outgoing mail file.  Again, any files downloaded will appear in a folder named "BulkRate downloads" in the same folder as the BulkRate application.  A message will appear in your incoming mailbox to inform you of the success or failure of the retreival request.
  585.  
  586. *BulkRate Help         File transfers                               Uploads
  587.  
  588.  672 
  589. UPLOADS
  590.  
  591. You may attach files to outgoing messages with the "Attach file" item under the Mail menu and the "ATTCH" button on the Palette.  The paths to these files will appear in the "Attached files" field on the Outgoing mail window.  The files themselves are not saved or copied in any way.  When the mail exchange occurs, BulkRate will expect to find the file(s) in the same place as when you attached the file to the message.  If you move the file, rename it, or rename any folder in the path to the file, BulkRate will not be able to locate the file.
  592. You can delete an attached file from a message by clicking on its path and pressing the delete key on your keyboard.
  593.  
  594. *BulkRate Help         File transfers                               Protocols
  595.  
  596.  388 
  597. FILE TRANSFER PROTOCOLS
  598.  
  599. BulkRate uses the XModem-1K CRC file transfer protocol for all file transfers.  This protocol was chosen for the following reasons:
  600. 1) It is much easier to program than the ZModem protocol.
  601. 2) ZModem in the FirstClass CLUI seems to fail on occasion, causing a crash of the CLUI session, much the same way an overly large message can crash the CLUI message editor.
  602.  
  603. *BulkRate Help         Threaded replies                             Threaded replies
  604.  
  605.  3866 
  606. THREADED REPLIES
  607.  
  608. BulkRate 2.1 now supports threaded replies.  This means that replies you generate with BulkRate will be properly inserted into the appropriate thread.  This will allow people using FirstClass Client to follow threads and find your replies using the "Next Thread" function in FirstClass Client, and message histories will now show your replies.  Some BBSs discourage the use of BulkRate because its replies have fallen outside the threads; now this will no longer be the case.
  609.  
  610. You can turn on threaded replies for a given service by choosing "Service setup..." under the Service menu.  Click the "Exchange Settings" icon. Check "Use threaded replies".  You may also want to add your screen name as it appears on that service to prevent replies from being sent back to your mailbox.  Close the dialog by hitting "OK" and save the changed service file by choosing "Save service" under the Service menu.
  611.  
  612. Drawbacks
  613.   There are two major drawbacks to threaded replies, which is why they are implemented as an option in BulkRate:
  614. 1) Posting a threaded reply is slower than posting a new message or a non-threaded reply.
  615. 2) Threaded replies have constraints on addresses placed in the To and cc fields of a message.
  616.  
  617. How threaded replies work
  618.   When you create a reply, information is stored with the reply that tells BulkRate what conference the original message was in, how to get to that conference from the Desktop, and identification information for the actual original message in the conference (a message "header").
  619.   During an exchange, when a threaded reply is found, BulkRate navigates to the original conference and opens it, requesting a list of all messages in that conference. (This can be rather time consuming if the conference has many messages in it.)  It then finds the original message in the message list and sends a command to reply to that message.  The FirstClass CLUI then starts a reply and lets BulkRate finish it.
  620.   The fact that the FirstClass CLUI starts the reply for you places some constraints on message addressing.  The addresses that the FirstClass CLUI automatically enters when generating a reply cannot be removed from the reply.  You may add addresses, but you cannot remove any.  If, while editing a reply in BulkRate, you remove any existing addresses or press the delete key while editing either address field, the reply will no longer be treated as a threaded reply to prevent copies of the message from going to people or conferences you do not expect.
  621.   
  622. Threaded or not?
  623.   You can choose to enable threaded replies for a given service or not; you may also elect to "de-thread" any given reply by unchecking the "Threaded reply" checkbox in the Outgoing message window.  Why might you want to NOT use threaded replies?  Since BulkRate must ask for a message list that includes EVERY message in the original conference in order to locate the original message, this can get quite slow.  (BulkRate is smart enough to use the list for multiple replies to the same conference, if those replies are next to each other in the outgoing mail file).  This slowness might not bother you with a fast modem, but if you use BulkRate at 2400 bps, it can slow things down quite a bit.  Non-threaded replies and new messages are sent much faster, since there is no need to locate the original message.
  624.   Sometimes the choice is made for you: if you delete any existing addresses from a reply, the reply becomes de-threaded.  In interests of speed, replies to messages in your Mailbox that have been sent only to you and not to any other people or conferences are also initially non-threaded, though you can change that before closing or saving the message.
  625.   In any case, once a reply has been saved as a non-threaded reply, there is no going back: the information that would connect the reply to the orginal message is lost.
  626.  
  627. *BulkRate Help         Scripting                                    Editing scripts
  628.  
  629.  1909 
  630. SCRIPTING
  631.  
  632. BulkRate now supports two types of scripts.  The first is a script that tells BulkRate when and with what services to exchange mail, and can be used to automate the exchange of mail with several BBSs.  The second is a log on script, which is similar to FirstClass Client's log on script function and is decribed in the next section.
  633.   You can create documents which tell BulkRate which BBS to exchange mail with, and then what to do afterward.  These scripts can be run manually, or by double-clicking them from the Finder.  To create a script, choose "Script..." from the Mail menu.
  634.  
  635. Run:
  636.      This section determines what will happen if the script if invoked by double-clicking it from the Finder.  If "Manually" is selected, the script will wait for you to run it manually by clicking "Run now" in this window.  If "Automatically when opened" is selected, the script will run immediately after being double-clicked.  If "Wait until:" is chosen, the script will run as soon as the entered time is reached.
  637.  
  638. When finished:
  639.      BulkRate can do one of three things when a script completes: nothing (Wait); quit BulkRate (Quit), or shut down the Macintosh (Shut down).
  640.  
  641. Exchange mail with:
  642.      This list tells BulkRate which Services (BBSs) to exchange mail with when this script is run.  BulkRate will call the first service; if it is busy, it will move on to the next service.  Unless there is an error or the redials exceed the limit you set in Preferences, it will continue trying to exchange with every Service listed here until they've all been completed.
  643. Add services to this list by clicking the Add... button; delete services from the list by selecting one, then clicking Delete.
  644.  
  645. Open...
  646.      Allows you to open a previously saved script.
  647.  
  648. Save as...
  649.      Allows you to save the current script.
  650.  
  651. Cancel
  652.      Exits this dialog without running the script.
  653.  
  654. Run now
  655.      Runs the script now.
  656.  
  657. *BulkRate Help         .fcl log on scripts                          .fcl log on scripts
  658.  
  659.  2434 
  660. .FCL LOG ON SCRIPTS
  661.  
  662. BulkRate 2.1 supports .fcl logon scripts.  These are the same style of logon scripts supported by FirstClass Client.
  663.  
  664. How logon scripts work
  665.    A logon script takes over after the "CONNECT" message is received from the modem.  It then performs a series of actions, typically waiting for certain prompts and sending certain characters until it reaches the end of the script.  At this point, BulkRate expects to be able to proceed normally with the logon process.
  666.  
  667. Do I need a logon script?
  668.   If you do not use a .fcl script currently with FirstClass Client, you do not need a logon script.  Logon scripts are typically used when the connection is routed through one computer before being transferred to the FirstClass Host.  If you do use a .fcl script, the same script will probably work with BulkRate.
  669.  
  670. How do I set up a logon script?
  671.   If you are going to use an existing logon script, make a copy of the one you are using with FirstClass Client.  Rename it "Service filename.fcl", where "Service filename" is the name of the Service file. Put the script in the same folder as the BulkRate application.
  672.   If you are creating a logon script, name it and place it as above.
  673.   BulkRate will look for the script during logon; if it finds one with the proper name, it will run it.
  674.  
  675. How do I write a logon script?
  676.   Here are the supported commands:
  677.  
  678. waitFor "text1" "text2" -t
  679.  
  680.   Waits for text1 or text2 to be received.  Text2 is optional.  t is a timeout value in 1/60ths of a second.  So if you need BulkRate to wait for a password prompt, but proceed after 2 seconds if it isn't received:
  681.  
  682. waitFor "Password:"  -120
  683.  
  684. send "text"
  685.  
  686.   Sends text over the serial port.
  687.  
  688. delay t
  689.  
  690.   Delay t 1/60ths of a second.
  691.  
  692. display "text"
  693.  
  694.    Writes text to the log.
  695.  
  696. Text in all commands supports three special characters, indicated by "¥r", "¥n", and "¥¥".  These send a return character, the linefeed character, and the backslash character respectively.
  697.  
  698. A sample logon script might look like this:
  699.  
  700. delay 60
  701. send "¥r¥r"
  702. waitFor "ID:" -120
  703. send "ABC¥r"
  704. waitFor "Password:" -120
  705. send "123¥r"
  706. delay 60
  707.  
  708. Now, in English:
  709.  
  710. Delay 1 second.
  711. Send two return characters.
  712. Wait for "ID:" prompt, or 2 seconds, whichever is first.
  713. Send "ABC" and return.
  714. Wait for "Password:" prompt, or 2 seconds, whichever is first.
  715. Send "123" and return.
  716. Delay 1 second.
  717.  
  718. At this point, the standard logon procedure for the FirstClass CLUI would happen.
  719.  
  720. *BulkRate Help         Modems                                       Serial ports
  721.  
  722.  735 
  723.  
  724. MODEMS
  725.  
  726. Setting up your modem to work with BulkRate is usually very easy.  Unfortunately, there are many, many modem manufacturers, and so-called "Hayes-compatible" modems are not terribly compatible with each other.
  727. The following info may help you determine the best settings you use with your modem.
  728.  
  729. Serial ports
  730.      BulkRate currently works only with modems connected to the modem port or the printer port.  In some cases, modems ship with software that makes them appear to the Mac to be connected to the modem port, even if they are actually connected to an internal slot, as in the PowerBooks, or to an ADB port, as in the case of some models of Global Village modems.  BulkRate may or may not work with these types of modems.
  731.  
  732. *BulkRate Help         Modems                                       Modem speed
  733.  
  734.  1209 
  735. Modem speed
  736.      BulkRate should work with any modem capable of a speed between 1200 bps and 28,800 bps.  Typically,  high-speed modems use a method of connection in which the computer-to-modem speed is higher than the modem-to-modem speed.  With a modem that is rated at 14,400 bps it is usually recommended to raise the serial port speed to 19,200 or 38,400 bps to allow data compression to work.  The speed you specify in the Modem settings dialog is the COMPUTER-TO-MODEM speed, not the modem-to-modem speed.
  737. Upon connecting to the remote modem, your modem returns a "CONNECT" message.  This message can report one of two values, the computer-to-modem speed (DTE speed) or the modem-to-modem speed (DCE speed).  Often it is possible in the initialization string to tell the modem which type of speed report to make.  If your modem is reporting the DCE speed and you are using hardware handshaking, you should uncheck the "Adjust BPS after connect" setting.  If this is checked, BulkRate will readjust the serial port speed to match the speed reported by the CONNECT message.  For low-speed modems, this is usually the right thing to do, but for high-speed modems, this is usually the wrong action to take.
  738.  
  739. *BulkRate Help         Modems                                       Hardware handshaking
  740.  
  741.  1531 
  742. Hardware Handshaking
  743.      Most high-speed modems currently support hardware handshaking.  If yours does, you may turn this feature on in the Modem settings dialog.  In fact, BulkRate forces you to do so at serial port speeds greater than 9600 bps.  Make sure you have a modem cable that is properly wired for hardware handshaking.
  744.  
  745.      Note that due to the small number of pins in Macintosh serial ports, most modem cables use the same line to sense DTR (Data Terminal Ready) and to sense CTS (Clear To Send).  The DTR line is often used to support "hardware hangup," in which a voltage transition causes the modem to immediately disconnect.  CTS is one of the hardware handshaking lines.  Since both lines are connected to the same cable pin, a voltage transition on one is indistinguishable from a voltage transition on the other.  If your modem is transferring data too fast for the Mac and the Mac pulls the CTS line to tell the modem to pause a bit, the DTR line will go down as well.  If the modem is set to disconnect on DTR transition, you'll be disconnected.  The bottom line is that in most instances, if you turn hardware handshaking on, you must set the modem to ignore the status of the DTR line. (Typically the correct command is &D0, though your modem may vary.)  Failure to do this will cause unwanted disconnects, especially when downloading or otherwise transferring a lot of data to your Mac.
  746.  
  747. Note also that this advice is not unique to BulkRate; it applies to all uses of high-speed modems with the Macintosh.
  748.  
  749. *BulkRate Help         Modems                                       Initialization strings
  750.  
  751.  1194 
  752. Initialization strings
  753.      This can be a source of great confusion and frustration.  In most cases, the default modem settings for use with the Mac are the appropriate ones.  Some manufacturers use "ATZ" to restore these settings, others "AT&F" or "AT&F1".  See your modem manual for details.
  754.      Specifically, your modem must be set up to echo local commands (typically "E1"), provide responses to commands (typically "Q0"), and provide responses in verbal format ( typically "V1").  If you wish BulkRate to properly respond to busy signals and no dialtone situations, the modem must support the "X4" command set.  Given these parameters, a default setup string for a 2400 bps modem would be "ATE1Q0V1X4". 
  755.      If you are using hardware handshaking, this must be turned on in the modem by the setup string, and the modem must be set to ignore DTR.  Unfortunately, the commands to do these things vary incredibly from modem model to modem model, so I can't give you specific commands here.  Your modem manual should be of some help here.
  756.  
  757. Here are some strings that are known to work:
  758.  
  759. SupraFAXModem: AT&F1 
  760. Global Village Teleport Gold: AT&F1
  761. Generic 2400: ATE1Q0V1X4
  762. Generic 1200: ATE1Q0V1
  763.  
  764. *BulkRate Help         Limitations                                  Limitations
  765.  
  766.  1931 
  767. LIMITATIONS
  768.  
  769. Unlisted conferences
  770.      BulkRate cannot currently send new mail to unlisted conferences.  Unlisted conferences are conferences which you cannot post to from your mailbox.  Using the threaded reply feature, you can, however, reply to messages in unlisted conferences.
  771.  
  772. Styled text:
  773.      No font, sixe, style, or color information is available via the FirstClass CLUI, so BulkRate cannot support styled text. 
  774.  
  775. Extended characters:
  776.      The FirstClass CLUI apparently supports only 7-bit ASCII, so Macintosh extended characters (like: 玄左ォトゥúöニûツオ÷ソケマィァ ャテキナエスチェ」「ー、ヲサシミュメヤノセイウヨ`ヌ) are not reliably supported. This can cause problems when reading text that has these characters, especially "curly quotes", en and em dashes, and the like.  This problem is more important, however, in sending messages; if a user or conference has extended characters in its name, you may experience problems sending mail to that address.  Try abbreviating the name to work around this problem.
  777.      When sending a message, BulkRate will translate extended characters to standard ASCII.  This translation is controlled by STR# resource 5000.  You may edit this using ResEdit or a similar tool if you do not like the character translations I have chosen.  String 1 in the resource is the translation for character 128 (\), string 2 is the translation for character 129 () and on to string 128, which is the translation for character 255.  To change the translation for character 180 (エ), you would edit string 53 (180 - 127 = 53) in STR# resource 5000.  Note that not all extended characters display the same in every font.
  778.  
  779.   
  780. SoftArc has indicated that they plan to eventually release a "Client Toolkit" or "Client API," which would eliminate many of the shortcomings of using the CLUI as BulkRate's interface with FirstClass.  A Client API should allow support for threaded messages and replies, styled text, and extended characters.
  781.  
  782. *BulkRate Help         Hints and tips                               Reading and editing during an exchange
  783.  
  784.  676 
  785. HINTS AND TIPS
  786.  
  787. Reading and editing during an exchange
  788.      Unlike earlier versions of BulkRate, you can actually do other things while a mail exchange is taking place.  You can work in other open applications, or you can read mail from another BBS, or you can read mail as it comes in during an exchange.
  789.  
  790.      Try not to leave a dialog box or alert on the screen for too long while an exchange is in progress; they do not allow any processor time to be devoted to the exchange and certain actions can then timeout.  In most cases, BulkRate allows a full minute before timing out, so as long as the dialog box or alert is acted upon in less than a minute, you should be fine.
  791.  
  792. *BulkRate Help         Hints and tips                               Moving and renaming BulkRate files
  793.  
  794.  657 
  795. MOVING FILES AROUND
  796.  
  797. BulkRate has to keep track of the location of a lot of files.  If you move or rename mailboxes or settings files, BulkRate may not be able to find them when running an exchange or script.  You can force BulkRate to update the location of mailboxes by using the "Mail settings..." dialog under the Service menu.  To update the location of Service files in a Script, you must delete the Service file from the Script list and re-add it.
  798. If you move an Address Book file, you'll need to re-open it in order for BulkRate to use it as the default address book file.  Otherwise BulkRate will continue to look in the OLD location for the file.
  799.  
  800.  
  801. *BulkRate Help         Hints and tips                               Adding a メsignatureモ to your messages
  802.  
  803.  2455 
  804. ADDING A メSIGNATUREモ TO YOUR MESSAGES
  805.  
  806. BulkRate supports a メtaglineモ feature, in which a randomly chosen single line メtaglineモ is appended to the end of your message.  On the Internet, multi-line メsignatureモ files are very popular ways to end newsgroup postings and e-mail.  You can have BulkRate automatically add a メsignatureモ to the end of each outgoing message you send.  To do so, you must create one or more text files and place them in the same folder as the BulkRate application.
  807.  
  808. The file names must end in メ.sigモ.  When BulkRate sends a message, it first looks for a メ.sigモ file with the same name as the メHost nameモ of your Service file.  If you have a Host name of メLAMG BBSモ, BulkRate will look for a file named メLAMG BBS.sigモ.  If it doesnユt find a file with this name in the same folder as the BulkRate application, it then looks for a file named メBulkRate.sigモ.  Failing that, it does not append any .sig text to your outgoing message.
  809.  
  810. Be sure that the filename of the signature file (if it isn't named メBulkRate.sigモ) is the same as the Host name , not the service filename .  For example, if your service filename is メLAMGモ, but the Host name (as it appears in the service window) is メLAMG BBSモ, a signature file named メLAMG.sigモ won't work, but a signature filename of メLAMG BBS.sigモ will work.
  811.  
  812. Also note that a specific service signature file will be used in place of the BulkRate.sig file, not with it.
  813.  
  814. You can use any word processor or even TeachText to create your メ.sigモ files; just make sure that the file is saved in メTEXTモ format.  Unfortunately, there is no easy way to create a .sig file from within BulkRate.
  815.  
  816. However, there is a way to create a .sig file from within BulkRate, though it will require a little extra editing on your part to do so.  Select ヤCompose newユ from the Message menu.  Ignore the message header info and just enter the text you want into the body of the message.  When you're satisfied with your signature, select ヤSave as textユ from the File menu and save the message with the .sig name you wish to give it.  The file will be saved as a SimpleText text file.  Once it is saved, click the close-box of the message window, and when prompted to save the message, click the Don't Save button so that the message will be eliminated from your outgoing mail.  Since the Save as text feature includes the message header, you'll have to edit the text file once it is saved to remove the header information.
  817.  
  818. *BulkRate Help         Registration                                 Registering BulkRate
  819.  
  820.  1070 
  821. REGISTERING BULKRATE
  822.  
  823. BulkRate is shareware.  You may try BulkRate for free, and give copies of the unregistered application to your friends. I ask that all documentation be included if you pass it on to a friend or upload it to a BBS.
  824. If you wish to continue using BulkRate, I ask a shareware fee of $25 US.  You may mail a check or money order (or cash) to:
  825.  
  826. Greg Neagle
  827. 1924 Mentone Ave.
  828. Pasadena, CA 91103
  829.  
  830. Include your name and return address.  I will return a registration code that will turn off the "evaluation copy" messages and enable file transfers.
  831. If you include a blank floppy and a stamped, self-addressed envelope, I will send you a copy of the latest version of BulkRate.
  832.  
  833. If you live outside of California, you may pay for Bulkrate via MasterCard or Visa.  Your credit staement will show a charge from "DigitalPopcorn Online Services."  They are the authorized reseller of BulkRate registrations.
  834.  
  835. To register via e-mail, send mail to greg_neagle@pop.com and include Visa or MasterCard number, expiration date, and your name as it appears on your card.
  836.  
  837. *BulkRate Help         Support                                      BulkRate support
  838.  
  839.  341 
  840. SUPPORT
  841.  
  842. I am happy to help people with BulkRate.   I am very bad at answering snail mail and I don't usually like to be called at home, which is why I recommend that you ask me questions online.   You may post questions in the BulkRate conference available on OneNet, or send me questions at my Internet e-mail address: greg_neagle@pop.com.
  843.  
  844. *BulkRate Help         Credits                                      BulkRate credits and copyrights
  845.  
  846.  969 
  847. CREDITS
  848.  
  849. I'd like to thank the following people and organizations for their help and support:
  850.  
  851. my wife, Allison
  852. DigitalPopcorn Online Services
  853. Dori Smith
  854. Jerry Klorman
  855. Kevin Pfeiffer
  856. Los Angeles Macintosh Group
  857. MacValley Users Group
  858. Paul Hampton
  859. Pete Johnson
  860. Reed Hutchinson
  861. Scott Goldman
  862.  
  863. and all beta testers and users of previous versions of BulkRate, for their comments and suggestions.
  864.  
  865. Portions of BulkRate are copyright ゥ  Zedcor and Staz Software, the balance is copyright ゥ 1995 Greg Neagle.
  866.  
  867. The next time you are in Southern California, call these fine FirstClass BBSs:
  868.  
  869. DigitalPopcorn
  870. A FirstClass BBS with Internet e-mail, Usenet newsgroups, and more.
  871. Administrator: Kevin Pfeiffer
  872. (818) 398-3303 Pasadena 
  873. (818) 843-7919 Burbank 
  874. (213) 462-5919 Los Angeles westside 
  875. (818) 988-4750 Van Nuys 
  876.  
  877. LAMG BBS
  878. The BBS of the Los Angeles Macintosh Group
  879. Administrator: Reed Hutchinson
  880. (310) 559-6227 West LA
  881.  
  882. I can be reached as "Greg Neagle" on any of these BBSs.
  883.  
  884.